---
title: Installation
description: Getting started
---

import {
  NextJS,
  ReactRouter,
  ReactRouterV7,
  ReactSPA,
  Remix,
  TanStackRouter,
} from '@/src/components/frameworks'

Install the `nuqs` package with your favourite package manager:

```npm
npm install nuqs
```

## Which version should I use?

`nuqs@^2` supports the following frameworks and their respective versions:

- <NextJS className='inline mr-1.5' role="presentation"/> [Next.js](/docs/adapters#nextjs): `next@>=14.2.0` <small className='text-muted-foreground'>(app & pages routers)</small>
- <ReactSPA className='inline mr-1.5' role="presentation" /> [React SPA](/docs/adapters#react-spa): `react@^18.3 || ^19`
- <Remix className='inline mr-1.5' role="presentation" /> [Remix](/docs/adapters#remix): `@remix-run/react@^2`
- <ReactRouter className='inline mr-1.5' role="presentation" /> [React Router v6](/docs/adapters#react-router-v6): `react-router-dom@^6`
- <ReactRouterV7 className='inline mr-1.5' role="presentation" /> [React Router v7](/docs/adapters#react-router-v7): `react-router@^7`
- <TanStackRouter className='inline mr-1.5 not-prose' role="presentation"/> [TanStack Router](/docs/adapters#tanstack-router): `@tanstack/react-router@^1`


<Callout>
  For older versions of Next.js, you may use `nuqs@^1` (documentation in `node_modules/nuqs/README.md`).
</Callout>
